home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr38 / kaboom21.zip / KABOOM21.DOC < prev    next >
Text File  |  1995-01-23  |  37KB  |  717 lines

  1.  
  2.  
  3.  
  4.  
  5.                                                                     KABOOM!
  6.                                                                            
  7.                                                                 version 2.1
  8.                                                                            
  9.                                                                            
  10.                                 A multi-node game door for most BBS systems
  11.                                       Copyright 1995 by DIRT CHEAP SOFTWARE
  12.                                                Written in C by Bruce Bowman
  13.                                                    Released January ?, 1995
  14.                                                                            
  15.                                INTRODUCTION
  16.                                ------------                                                                          
  17.                       (and obligatory legal garbage)
  18.  
  19.  --------------------------------------------------------------------------
  20. | >Disclaimer<  Throughout this document, I have used the masculine gender |
  21. | when referring to a "generic" person.   This is only to avoid continuous |
  22. | use of such things as (s)he, which I find annoying. I have total respect |
  23. | for the females of the species; I even married one. So lighten up.   :^) |
  24. |   --------------------------------------------------------------------   |
  25. | >Disclaimer #2<  The author of this program, Bruce Bowman, promises only |
  26. | that this program will take up space on your hard drive (and perhaps not |
  27. | even that). I've put a lot of my time and sweat equity into this, and in |
  28. | return I ask only that you  try it and remit a token sum if you continue |
  29. | to do so. I make no claims for its suitability for a particular purpose, |
  30. | and guarantee nothing  whatsoever regarding potential damage to your own |
  31. | computer or hard-acquired files.  I can only suggest that you  do what I |
  32. | do, and back up  your hard drive frequently.  If the unthinkable happens |
  33. | and some terrible fate should befall you  as a direct or indirect result |
  34. | of using KaBoom!,  you will have my utmost sympathy  -- but that's about |
  35. | all. So there.   :^)                                                     |
  36. |                           --------------------                           |                      
  37. | This software is copyrighted: You're subject to the associated penalties |
  38. | of law if you attempt to reverse-engineer it, hack the key routines,  or |
  39. | otherwise steal the benefits of all my aforementioned sweat equity.      |
  40.  --------------------------------------------------------------------------
  41.  
  42. I'll freely admit it -- I was inspired to write KaBoom! by an article in a 
  43. magazine. There were even some code snippets, but in another language. As I 
  44. wrote it, more and more ideas for improvements came to mind, so they were 
  45. incorporated. The final product, I feel is as good as any door I've seen -- 
  46. and at only $10 is a bargain in shareware.
  47.  
  48. KaBoom! offers the following sysop features (and more I've probably
  49. overlooked in these docs):
  50.  
  51. -  As you would expect, KaBoom! monitors carrier detect functions, to
  52.    automatically recover when a user drops carrier.                    
  53.                                                                        
  54. -  Includes a fully-adjustable inactivity timeout monitor. A warning is
  55.    sent 15 seconds before the caller is ejected.
  56.  
  57. -  Share-aware file i/o for use in multi-node BBS systems. You must have 
  58.    DOS's SHARE.EXE loaded for multi-node use.             
  59.  
  60. -  Supports most popular BBS door information files, such as DORINFO1.DEF,
  61.    EXITINFO.BBS, CHAIN.TXT, DOOR.SYS, etc.  
  62.  
  63. -  Supports monochrome monitors and computers that do not support the entire
  64.    IBM character set.
  65.  
  66. -  Displays and updates a QuickBBS-style status line, with information 
  67.    available to the sysop such as user name, location, baud rate, time left, 
  68.    function keys, ANSI and AVATAR settings, and so on.
  69.    
  70. -  Keeps track of a user "wants-chat" indicator, just like the one in
  71.    RemoteAccess, QuickBBS and other BBS systems. Allows for sysop page from
  72.    the door, and integrated chat mode.
  73.  
  74. -  Provides the sysop with all the standard function keys for adjusting user 
  75.    time, hanging up on or locking out the user -- and sysop shell to DOS.
  76.  
  77. -  Full support for locked baud-rates of up to 115200 baud, using the FOSSIL
  78.    driver for maximum compatibility with any system. If a FOSSIL is not
  79.    available, KaBoom! will use its own communications routines. Support for
  80.    non-standard comm ports, and auto-detect of local operation.
  81.  
  82. -  KaBoom! is also DesqView and Windows aware. It will automatically check 
  83.    for the presence of a multitasker, and if available, will perform all of 
  84.    its screen output through the appropriate function calls.
  85.  
  86.  
  87.                             KABOOM! QUICKSTART
  88.                             ------------------
  89. To get the door up and running, perform the following...
  90.  
  91. 1) Copy the KABOOM.EXE file to the directory from which you plan to run
  92.    the door.
  93.  
  94. 2) Create a door batch file, similar to the following: 
  95.  
  96.        CD \BBS\DOORS           (location of KABOOM executable)
  97.        KABOOM <parameters>     (see below)
  98.        CD \BBS
  99.        EXIT
  100.  
  101. 3) Create a menu entry to call the door. This varies according to your
  102.    BBS software. I recommend a "spawn" type of door call (e.g.: type 7 on
  103.    QuickBBS or Remote Access).
  104.   
  105. That's really about all there is to it! Now, you need to know about the
  106. command line parameters, so here goes...
  107.  
  108.       
  109.                           COMMAND LINE PARAMETERS
  110.                           -----------------------
  111. ** Soapbox mode ON **
  112. One thing that has always irritated me is the number of config files and
  113. the like that clutter my directories. I see no need to have an executable, 
  114. a maintenance program, a config file and program, and a data file for each 
  115. game (like many door programmers prefer). Although harder to do, I've 
  116. designed KaBoom! so it doesn't need all those files -- all it uses, besides
  117. the executable, is two data files (the Hall of Fame and a user activity 
  118. log). KaBoom! configuration is done exclusively via command line parameters.           
  119. ** Soapbox mode OFF **
  120.  
  121. Call the program with the following syntax. Only the <path> parameter is
  122. required. Parameters indicated with an asterisk (*) can only be configured
  123. in the registered version.
  124.  
  125.  
  126. KABOOM <Path> <Time> <Games*> <Sleep*> <Bombs*> <PageOff*> <PageOn*> 
  127.  
  128.                                                     [ <Baud> <IRQ> <Add> ]
  129.                   
  130. Where:
  131.  
  132. Path      REQUIRED: Path to the door drop file(s). This will vary depending 
  133.           on the node using the door. I usually set things up so the node 
  134.           number is passed on the batch file command line, so the door can 
  135.           be called with something like:  KABOOM \BBS\NODE%1. That way, you 
  136.           can use the same batch for any number of nodes. 
  137.           You can also force KaBoom! to preferentially read a particular
  138.           drop file by placing its name along with the full path. This can
  139.           handy if KaBoom! is reading one drop file first that doesn't
  140.           have the data it needs to run properly.
  141.           
  142. *Time     Maximum time, in minutes, you will allow a caller to spend in
  143.           the door. Default is the total amount of connect time left to the
  144.           caller (i.e.: no restriction). A warning is sent shortly before 
  145.           the caller runs out of time.          
  146.           To use the default but still specify a value for one of the 
  147.           subsequent parameters, insert XX (or any other string of 
  148.           *non-numeric* characters) as a placeholder.
  149.  
  150. *Games    Maximum number of games an individual may play in one session. 
  151.           Default value is 5, acceptable range is 1-32767. A value of zero
  152.           is ignored, and will give the default instead.          
  153.           Again, insert a non-numeric placeholder if you want to specify a 
  154.           value for any subsequent parameters.
  155.                     
  156. *Sleep    Time, in seconds, before a user is returned to the BBS for
  157.           inactivity. If your caller goes to sleep at the terminal, this
  158.           will bump him off and back to the BBS; a warning will be sent 15 
  159.           seconds beforehand. Keep this number high enough that the caller 
  160.           can examine the grid for a reasonable length of time. Default is
  161.           200 seconds (quite generous for an arcade-style game).
  162.                                         
  163. *Bombs    Number of bombs on the play grid for level 0. Higher levels have 
  164.           5 more bombs than the previous level. The acceptable range is 
  165.           10 - 49 bombs. Difficulty increases rapidly once you get past 
  166.           about 20 bombs, so the default (15) is a good choice.           
  167.           If you change this number frequently, it will be impossible to 
  168.           compare your caller's Hall of Fame entries with any degree of 
  169.           fairness. I suggest you delete the KABOOM.HOF file whenever this
  170.           value is changed -- thereby starting a new Hall of Fame.
  171.                                                   
  172. *PageOff  Time, in minutes after midnight, for paging hours to end. Legal
  173.           values are 0-1440. By default, paging is always on; so if you
  174.           enter an invalid number, that's what you'll get.  
  175.   
  176. *PageOn   Time, in minutes since midnight, for paging hours to resume. If 
  177.           you *never* want a caller to page you, enter a value of exactly 
  178.           midnight (zero) for PageOn, or simply don't provide a value for
  179.           PageOn at all. 
  180.           
  181. USE THE FOLLOWING PARAMETERS ONLY IF YOU DO NOT USE A FOSSIL FOR MODEM I/O!
  182. Using any of these parameters disables use of the FOSSIL. In most cases, it
  183. is better to set one or more of these values on your FOSSIL command line and
  184. just use the FOSSIL for i/o -- but if your BBS software does not require a 
  185. FOSSIL, or for some reason you prefer the FOSSIL not be used, you can still
  186. run the door using these parameters and KaBoom's internal comm routines. 
  187.  
  188. <Baud>    The computer-to-modem data transfer rate (DTE speed). THIS IS NOT 
  189.           THE MODEM-TO-MODEM CONNECT SPEED. This value must evenly divide
  190.           115200 (115200, 57600, 38400, 28800, 23040, 19200, 14400, etc). Do
  191.           not use a comma (ie: do not enter the value as 57,600 -- it won't 
  192.           work). 
  193.           If all you want to do is force KaBoom to use its own comm routines,
  194.           you can again put XX or any other non-numeric placeholder string in 
  195.           this position. If you use hardware data compression on your modem 
  196.           (V.42bis or others), I suggest using a value of 4x your highest 
  197.           connect speed to avoid losing characters. For example, for a 9600 
  198.           baud modem with V.42bis, I recommend using 38400 here.
  199.  
  200. <IRQ>     Sets the IRQ line to be used by your modem. Normally, KaBoom will
  201.           determine the standard IRQ line used by COM1-COM4. If you use a
  202.           non-standard IRQ line for your modem (usually to avoid a conflict
  203.           with another device) place its value here. 
  204.           
  205. <Add>     Base address (in hex). KaBoom can normally determine the base 
  206.           address of the port for you. However, if you prefer to change the
  207.           base address, place its value here. MAKE SURE IT IS CORRECT!! If 
  208.           it isn't, KaBoom! will still dutifully follow your instructions 
  209.           and perhaps overwrite important areas of memory. If you don't 
  210.           understand any of this, DO NOT put ANYTHING here.
  211.           
  212.           Standard base addresses and IRQs follow. These are the values that
  213.           will be used based on the COM port passed in the BBS drop files,
  214.           unless remapped by your FOSSIL or on the KaBoom! command line:
  215.           
  216.                        COM1    03F8h and IRQ4
  217.                        COM2    02F8h and IRQ3
  218.                        COM3    03E8h and IRQ4
  219.                        COM4    02E8h and IRQ3
  220.  
  221. Examples:
  222. -------- 
  223.  
  224.    KABOOM \BBS\NODE1
  225.    
  226.          Bring up the door with the drop file located in the \BBS\NODE1
  227.          directory. All other parameters take their default values.
  228.          
  229.    KABOOM \BBS\NODE2 15 XX XX 30
  230.    
  231.          Run the door from node 2. Thirty bombs in level 0, and limit 
  232.          callers to 15 minutes in the door.
  233.     
  234.    KABOOM \BBS\NODE1 XX 10 XX XX 1260 420
  235.    
  236.          Run KaBoom! with a maximum of 10 games per person per day. 
  237.          Disable sysop paging at 9 p.m. and resume at 7 a.m.
  238.                      
  239.    KABOOM \BBS\NODE1 XX XX 300 XX XX XX XX 
  240.    
  241.          Run KaBoom!, forcing use of internal comm routines (assuming a 
  242.          FOSSIL is not available). Callers will be returned to the BBS
  243.          after 5 minutes (300 seconds) of inactivity.
  244.            
  245.    KABOOM \BBS\NODE%1 XX XX XX XX XX XX 115200 7 02E8
  246.    
  247.          Run KaBoom! using the internal comm routines and non-standard
  248.          modem settings indicated. The node passed on the batch file
  249.          command line is using the door.
  250.  
  251.  
  252.                               SYSOP FUNCTIONS
  253.                               ---------------
  254. Status Line - The status line lists the name of the user currently on-line, 
  255. his location, and baud rate (0 if the door is operating in local mode). You 
  256. may also find out how much time the user has left,  check for indicators as 
  257. to whether the user has ANSI and/or AVATAR modes on, etc. If the user wants 
  258. to Chat with the sysop (ie: they have paged the sysop, but haven't received
  259. a response), a "Want-Chat" indicator will flash on the status line. 
  260.  
  261. [F1]..[F10] - The Function keys [F1] thru [F10] allows the sysop access to 
  262.               various types of information on the status line, or to turn 
  263.               the status line off. These keys are as follows:
  264.  
  265.               [F1] -  Display basic door and user information
  266.               [F2] -  Display phone numbers and important dates
  267.               [F3] -  Display security flags and up/download info
  268.               [F4] -  Display system information and current time
  269.               [F5] -  Display message info and user's settings
  270.               [F6] -  Display chat reason and sysop's comment
  271.               [F9] -  Display help information for sysop
  272.               [F10] - Turn off the status line                               
  273.               
  274. The following other function keys are also available to the sysop:
  275.  
  276. [UP]/[DOWN] - Use these arrow keys to increase or decrease the amount of 
  277.               time the caller has left in the door.
  278.  
  279. [Alt]-[C] -   Allows the sysop to break into chat with the caller at any 
  280.               time. [Alt]-[C] again, or [ESC] will end chat mode. (Notice 
  281.               that the Want-Chat indicator will also be turned off, if it 
  282.               was flashing). If your door is running under Apex, Remote
  283.               Access or QuickBBS, paging from within the door will also
  284.               cause the Want-Chat indicator to stay lit when the user 
  285.               returns to the BBS.
  286.  
  287. [Alt]-[J] -   Allows the sysop to shell to DOS, if enough memory is 
  288.               available. Simply type EXIT to return to the door.
  289.  
  290. [Alt]-[H] -   Hang up on the user. Drops carrier and returns to the BBS.
  291.  
  292. [Alt]-[L] -   This key locks the user out of the BBS. It first hangs up 
  293.               on the user, and then sets their security level to 0, to 
  294.               prevent them from ever logging on again. This feature may 
  295.               require use of the EXITINFO.BBS file, depending on what 
  296.               system the door is running under.
  297.  
  298. [Alt]-[K] -   The "User Keyboard-Off" key allows the sysop to temporarily 
  299.               prevent the user from typing anything on their keyboard. 
  300.               This has no effect on the local keyboard, but causes the
  301.               door to ignore any keystrokes from remote.
  302.  
  303. [Alt]-[N] -   The "Sysop Next" key, this function reserves the system for 
  304.               use by the sysop after the user logs off, if the door is 
  305.               running under an Apex or RA 1.00 or later system.
  306.  
  307. [Alt]-[D] -   "Drop to BBS" key. This function allows the sysop to close 
  308.               the door and return the user to the BBS, without hanging up.
  309.  
  310.                                                       
  311.                              USING THE DOOR
  312.                              --------------
  313. The door is menu-driven, and most of the functions are self-explanatory. A 
  314. brief overview will be given here -- please see the online instructions for
  315. more details and strategy. The object of the game is to reveal all the
  316. squares of the grid without running into a bomb. A timer counts how long it
  317. takes a given user to do so. If the user is able to win in a time that is
  318. less than the lowest of the top 12 times, his name is added to the Hall of
  319. Fame!
  320.  
  321. To navigate the grid, the player must use either the 1235 keys on the 
  322. numeric keypad, or (for lefties or keyboards without a numeric keypad) the
  323. sdfe keys on the main keyboard. If using the keypad, the NUM LOCK key must 
  324. be on, while CAPS LOCK must be off to use the sdfe keys. This helps avoid 
  325. the caller accidentally hitting one of the other, command keys during the 
  326. course of the game, yet allows them to interrupt play at any time if they
  327. use both hands. I was hoping to use the arrow keys to move around, but the 
  328. extended code sequences these keys generate require remote callers to use 
  329. a "DOORWAY mode" that many communications programs do not support.
  330.  
  331. To reveal a square, use ENTER. Either the main keyboard or the keypad key
  332. will work. If you reveal a square that contains a bomb, you lose. If you
  333. think you know where a bomb is, mark the square with the space bar so you
  334. don't reveal it later. However, be careful -- one of the most frequent
  335. mistakes in playing the game is to mark a square that doesn't really have
  336. a bomb in it, so your later decisions based on this assumption turn out to
  337. be wrong. You can unmark the square by pressing the space bar again. 
  338.  
  339. If you attempt to mark a square that has already been revealed, or reveal
  340. a marked square, you will be assessed a time penalty. 
  341.  
  342. NOTE:  There's always a chance that, on your first move, you'll reveal a 
  343. square with a bomb and immediately lose. To eliminate this, I have set it 
  344. up so the square in the center (the one highlighted at the start of each
  345. game) never has a bomb. It is up to you whether you want to make your 
  346. callers aware of this fact! 
  347.  
  348. Other commands:
  349.  
  350.   N = Starts a new game immediately, terminating the current game.
  351.   Q = Quit and return to the BBS.
  352.   L = Logoff the board. Exits both the game and the current BBS session.
  353.       This may require EXITINFO.BBS drop file support on the part of your
  354.       BBS software.                     
  355.   R = Redraw screen -- just in case it gets messed up by line noise.
  356.   I = Displays pretty good game instructions and strategy.
  357.   P = Page sysop -- sounds a tone so you can come and initiate chat mode
  358.       (assuming you want to).
  359.   G = Graphics mode -- toggles on and off the use of high ASCII (extended
  360.       IBM characters) and ANSI color sequences. Useful for those who have
  361.       monochrome monitors or computers that do not support the full IBM 
  362.       character set.
  363.   C = Change level of difficulty. There are three levels -- each higher 
  364.       level places 5 more bombs on the grid than the previous level.
  365.   H = Displays the current Hall of Fame. There is a separate Hall of Fame
  366.       for each level of difficulty.
  367.  
  368. Note that the timer will continue to count while the computer processes
  369. these commands; so if you are in the middle of a game you might not want
  370. to stop to read the instructions right then.            
  371.  
  372. Tutorial Mode
  373. -------------
  374. One of the best features of version 2.0 and later of KaBoom! is tutorial
  375. mode. In this mode, players can select whether they wish to watch the 
  376. computer "play itself" and thereby learn strategy, or play their own game 
  377. and request help as needed.
  378.  
  379. To start tutorial mode, press 'T' at the beginning of a game (it cannot be
  380. toggled on during a game). The timer will be turned off, and you will be
  381. asked if you want to observe, play along, or abort. Games can be won and
  382. lost in tutorial mode, but since you receive computer help the game is not 
  383. eligible for addition to the Hall of Fame.
  384.  
  385. Watching the computer play is entertaining in itself. The door is designed
  386. so the computer never makes a blatant error; if there is any 'safe' move,
  387. the computer will always find it and make those moves first. Also, the 
  388. computer moves very rapidly and efficiently (I had to add a delay loop to 
  389. this mode just so people could see what it was doing!). 
  390.  
  391. However, in the course of any given game, there are situations where an 
  392. educated guess must be made. The very first move is a good example of this. 
  393. In these cases, the computer will always just pick a random square and 
  394. reveal it -- possibly losing in the process. A good human player can do 
  395. better by using some deductive reasoning and estimating the odds of 
  396. failure; but can't move as quickly!
  397.  
  398. Hint mode is very helpful for beginners. In this mode, the player still
  399. makes all the moves. However, whenever he wants some help, he can press
  400. the '?' key. The computer will then scan the board for a 'safe' move
  401. nearest to the current cursor position. If it finds one, it highlights a
  402. square and tells the player to either mark or reveal all of the adjacent
  403. blank squares. If there are no 'safe' moves, the computer will say so and
  404. suggest that the player guess. 
  405.  
  406. NOTE:  If the player marks a square incorrectly early in the game, the 
  407. computer will NOT be aware of the error -- it never makes a mistake like
  408. that in its own games. Sure, I can make it cheat and look at the actual 
  409. hidden grid, but I prefer to have it perform like a real player. In these
  410. situations, the computer may later suggest a move that causes the player's
  411. destruction. The nature of KaBoom requires that you make no mistakes of 
  412. this nature if you expect to win the game!
  413.  
  414.  
  415.                          CARE AND FEEDING OF KABOOM
  416.                          --------------------------                                 
  417. There really isn't any. The Hall of Fame is visible online, so you don't 
  418. have to run any maintenance or bulletin generators to display it. Any time
  419. you want to reset the Hall of Fame, just delete the KABOOM.HOF file. Also,
  420. if running multi-node, make sure you have DOS's SHARE.EXE loaded.
  421.  
  422.  
  423.                               REGISTRATION
  424.                               ------------
  425. To Other Shareware Authors:
  426.  
  427. I will happily exchange registrations to any of my products, if what you 
  428. have interests me at all.  Netmail me with the specifics if interested.
  429.  
  430. (Not responsible for lost or misrouted mail!).
  431.  
  432. The key consists of a small file that resides in the same directory as
  433. your game file (KABOOM.BBS). Ordinarily, I would find this abhorrent -- 
  434. but I'm just too stupid to figure out a way to patch the executable with 
  435. a key entered in a config program (which would also require a config 
  436. program!).
  437.  
  438. Benefits of Registration
  439. ------------------------
  440.  
  441. 1) The door will only allow configuration of the drop file path, com port 
  442. parameters, and/or the maximum time in the door until registered. You can go
  443. ahead and enter the extra parameters on the command line; but they will be 
  444. ignored. The defaults are pretty reasonable, though.
  445.  
  446. 2) You cannot disable paging or set paging hours unless registered.
  447.  
  448. 3) The door will display -= UNREGISTERED =- when returning to the BBS until
  449. you register. It also displays a shareware registration screen for 15-30 
  450. seconds every time someone uses the door.
  451.  
  452. 4) You will receive preferential support from the author.
  453.  
  454. 5) You will have peace of mind, knowing that you are supporting shareware.
  455.  
  456. The key routine could probably be cracked eventually by someone with a hex 
  457. editor and a lot of time on their hands. More elaborate protection schemes 
  458. than mine have suffered this fate. However, I'm not asking much money for 
  459. this -- so save yourself some effort and cough up the cash.
  460.  
  461. How do you register?  Send $10 (US) cash, check or money order to:
  462.  
  463.                        Bruce Bowman
  464.                        8364 S SR 39
  465.                        Clayton, IN  46118
  466.  
  467. Allow 2 weeks for personal checks to clear. I'm told it's not a good idea 
  468. to send cash via the mail, but I've never had problems with it. If you 
  469. decide to do so, and the money gets ripped off, I will feel sorry for you 
  470. but I won't waive your registration fee over it. Do NOT call the support 
  471. BBS to register -- we have no registration doors, nor do we accept credit.
  472.  
  473. Accompany this with the form on the following page...or otherwise provide 
  474. this information.  Registrations without this information WILL be ignored
  475. (I will make a feeble attempt to contact you, and eventually tear up your
  476. check).
  477.  
  478. It is also a VERY GOOD IDEA to send a copy of your drop files with your
  479. registration. Since the door reads data from your drop files to determine
  480. if the key will work, it is very important that both the sysop name and
  481. the BBS name be provided EXACTLY as present in your drop files. If you
  482. cannot guarantee this, you should send me your drop files.
  483.  
  484. On occasion I have attempted to netmail certain individuals keys, only to 
  485. get bad connects -- I simply cannot afford this. If your BBS is only online
  486. during certain hours, let me know. If I get two bad connects trying to 
  487. netmail a key, I will give up and put it on hold for you and notify you of 
  488. this fact via routed netmail (which itself is not very reliable anymore).
  489.  
  490. NOTE:
  491. Registered keyholders receive FREE UPGRADES when/if they become available.
  492. You will have to check in though, since I don't plan to notify everyone of
  493. an upgrade individually.
  494.  
  495.                           KABOOM! REGISTRATION 
  496.                                Version 2.1
  497.                               
  498. IMPORTANT!  The BBS name and SYSOP name must match your door   IMPORTANT!
  499. IMPORTANT! drop file EXACTLY, or your key won't work. Consider IMPORTANT! 
  500. IMPORTANT!     sending us a copy of your BBS drop file(s)!     IMPORTANT!                    
  501.  
  502. *SYSOP NAME: __________________________________________________________
  503.  
  504. ADDRESS: ______________________________________________________________
  505.  
  506. _______________________________________________________________________
  507.  
  508. _______________________________________________________________________
  509.  
  510. *BBS NAME: ____________________________________________________________
  511.  
  512. BBS Phone: ____________________________________________________________
  513.  
  514. BBS Software/Version: _________________________________________________
  515.  
  516. NETWORK: _______________________________________ (FidoNet, etc, if any)
  517.  
  518. NETWORK NODE NUMBER: _______ : ________ / ________ (if above completed)
  519.                                             
  520. AMOUNT ENCLOSED: ______________________      NOTE: Registration is $10!
  521.                                              
  522. HOW DO YOU WANT TO PICK UP THE KEY?
  523.  
  524. [ ] ... Put on hold for me at 1:231/710 for the Net/Node listed above.
  525.  
  526. [ ] ... Send via FidoNet crashmail to the node indicated above.
  527.  
  528. [ ] ... Here's $2.00 Upload it to me as well as the latest version.  
  529.         Acount Information as Follows:
  530.  
  531.         Account Name:  Bruce Bowman
  532.         
  533.         Password: ____________________________________
  534.         
  535.         Miscellaneous Info: ________________________________________
  536.  
  537.         ____________________________________________________________
  538.  
  539. [ ] ... Send on disk to the address above (very slow!) Please add $5 to 
  540.         cover disk, mailing costs, and my hassle.
  541.         Please ship my key and latest copy via  [ ] - 5.25"   [ ] - 3.5"
  542.  
  543. [ ] ... YES!! I WANT THE SPECIAL DEAL! Send me latest version of BCheckers
  544.         and its key for only $5 more!!
  545.  
  546. COMMENTS/SUGGESTIONS/BUGS: ____________________________________________
  547.  
  548. _______________________________________________________________________
  549.  
  550. _______________________________________________________________________  
  551. @2.1
  552.                             TECHNICAL SUPPORT
  553.                             ----------------- 
  554.  
  555. TECHNICAL SUPPORT IS PROVIDED ONLY THROUGH EMAIL OR CALLING MY BBS! 
  556.  
  557. I have had people ask me to call them long-distance on my dime -- I simply 
  558. don't make enough money on KaBoom! to justify this. There seems to be a
  559. perception amongst the sysop community that door authors are getting rich
  560. selling their doors, but the truth is the vast majority of sysops never
  561. register them. I've spent a LOT of time programming this door; hopefully 
  562. it will prove more lucrative than my other door has so far.
  563.  
  564. To obtain support, you must call my BBS or send me email. If you choose to
  565. call the BBS, you won't obtain full access to my BBS on your first call.
  566. But you can leave a message to the sysop at logoff, which I will get. In 
  567. your message, please leave me with some inexpensive (read: free) means of 
  568. contacting you. Once registered, I will happily help you with any problems 
  569. you might have -- on my dime.
  570.  
  571.                    The H.O.M.E. BBS
  572.                    (317) 539-6579 - 28.8 kbps
  573.                    FIDONET:  1:231/710
  574.                    DOORNET:  75:7317/71
  575.                    INTERNET: beb@lilly.com (best) or
  576.                              Bruce.Bowman@f710.n231.z1.fidonet.org
  577.  
  578. If you are having problems with your key, you MUST give me a copy of your 
  579. door drop files, or I won't be able to help you.
  580.  
  581.  
  582. FREQUENT COMPLAINTS
  583. -------------------
  584.  
  585. Q: The door can't find my key even though I've registered.
  586. A: Run the door from the directory containing the key. The executable 
  587.    can be anywhere on your path, and the drop file path is passed on the 
  588.    command line. If your key is named something else, be sure to rename
  589.    it to KABOOM.KEY.
  590.  
  591.    The 52-line DOOR.SYS drop file does not contain the system name.
  592.    Since the system name is necessary for the key routine to work, you
  593.    must create some other drop file. I suggest you use one of the many
  594.    drop file converters on the market to create an RA-compatible
  595.    EXITINFO.BBS file that KaBoom can read. Make sure to configure the
  596.    converter so it adds your BBS name to the new drop file. If your
  597.    BBS software creates other drop files in addition to DOOR.SYS, try
  598.    just adding DEL DOOR.SYS to the batch file before running the door.
  599.  
  600.    If it still does not recognize your key, you either did not provide 
  601.    the correct BBS and sysop names on your registration form, or your
  602.    system is misconfigured so this information is not appearing in your
  603.    drop files. Send a copy of your drop files to the support BBS or via
  604.    email to one of the addresses listed.
  605.                                                          
  606. Q: The game prints [2;4m brackets and other junk characters all over.
  607. A: The door requires full ANSI graphics capability for best operation, 
  608.    and at a minimum requires VT100 cursor positioning. Exit the door and 
  609.    rectify the situation, or try running the door in the non-graphics 
  610.    mode.
  611.   
  612. Q: The status line function keys don't work right -- they cause the door 
  613.    to act peculiar and even lock up.
  614. A: Have you defined the offending F-keys to launch a macro? Don't feel bad 
  615.    -- I did this myself in DESQview, and was pretty bewildered for awhile!
  616.                                   
  617. Q: The files KABOOM.HOF and/or KABOOM.USR exist, but I still occasionally 
  618.    get a message from the door saying "Error opening KABOOM.HOF/USR!"
  619. A: The door will try 20 times to open the file over a 10-second interval. 
  620.    If this fails, KaBoom! gives up with an error. 
  621.  
  622.    You may be running out of file handles. Increase the number of FILES in 
  623.    your CONFIG.SYS. 
  624.  
  625.    It is also possible that one task in a multi-tasking environment opened
  626.    the file, and then crashed without closing it. If so, you will probably
  627.    have to reboot to clear the error.
  628.  
  629.    This may also rarely happen during intensive disk activity in a multi-
  630.    tasking environment (for example, when copying files to/from floppies). 
  631.    Use a copy utility (like DVCOPY) that will properly release time slices 
  632.    to your door.
  633.  
  634.    You *do* have DOS's SHARE.EXE loaded, don't you?
  635.  
  636. Q: KaBoom! made an error and told me I lost when I know I should have won!
  637. A: I can assure you that the door will not mess up like that! Usually, the
  638.    problem is that you erroneously marked a square as containing a bomb,
  639.    when in actuality it did not. This will mess up your later decisions in
  640.    the game, and if you examine the final board carefully I think you will 
  641.    find that an alternative was overlooked.
  642.                                
  643.  
  644. PRODUCT HISTORY
  645. ---------------
  646. 10/94  Initial release, version 1.0. Support for monochrome monitors and
  647.        computers that do not support the high ASCII character set.                                      
  648.  
  649. 12/94  Version 2.0 released. 
  650.  
  651.        New features:
  652.        ------------
  653.        New TUTORIAL MODE! You can start a game in this mode, and the door 
  654.        will play an untimed demo game to show you applied strategy! 
  655.        
  656.        HINT MODE!  Play a game and request hints from the door as you
  657.        play!
  658.         
  659.        Three levels of difficulty, with different number of bombs and Hall
  660.        of Fame for each level!
  661.        
  662.        KaBoom! now detects a win when all of the bombs have been pinpointed
  663.        and marked. Previously, a win occurred when all the non-bomb squares
  664.        were revealed. Games should end a little earlier now, so you might 
  665.        want to use a couple more bombs. The door will still let you mark a 
  666.        square that doesn't have a bomb, so be careful!
  667.        
  668.        Bugs fixed:
  669.        ----------
  670.        KaBoom! now keeps a user log, so it no longer lets a caller play  
  671.        again after using up all their allowed games per day. The name of
  672.        this file is KABOOM.USR. The door automatically resets the log on 
  673.        the first caller of each day -- you don't have to maintain it. The
  674.        caller CAN reenter the door and view the Hall of Fame or whatever;
  675.        they just can't play a game until the following day.
  676.  
  677.        KaBoom! 2.0 now reliably clears the screen before initiating a page.
  678.        
  679.        KaBoom! 2.0 flushes the keyboard input buffer after a win or loss.
  680.  
  681.        KaBoom! 2.0 now prints a congratulatory message when the user enters 
  682.        the Hall of Fame, and clearly indicates that the ENTER key should be
  683.        pressed to continue.
  684.        
  685.        Callers can no longer use type-ahead to circumvent a time penalty. 
  686.  
  687.  1/95  Version 2.1 released -- mostly bug fixes and minor enhancements.
  688.  
  689.        Releases time slices more often. This should make it more friendly 
  690.        to multitaskers.
  691.        
  692.        KaBoom! now parses multiple drop files more effectively. This
  693.        should solve some rare/intermittent problems with key recognition.
  694.        
  695.        The QuickBBS format of EXITINFO.BBS file is now handled properly. 
  696.        This should fix the "time left" problem on returning to QuickBBS. 
  697.        
  698.        Fixed a bug where the timer sometimes locked in the OFF position if
  699.        you played a couple of games in tutorial mode.                         
  700.        
  701.        Previous versions of KaBoom! required XON/XOFF handshaking if a
  702.        FOSSIL was not available. Hardware handshaking is now supported.
  703.        
  704.        Non-standard IRQs and base addresses are now supported if not using
  705.        a FOSSIL.
  706.        
  707.        
  708.                             FUTURE OF KABOOM!
  709.                             ------------------- 
  710.                             
  711. I have a few ideas that I may implement, but I do want to be careful that I
  712. not make the game too elaborate without increasing the "fun factor!" 
  713.  
  714. Registered users get FREE UPGRADES.
  715.  
  716. While I think KaBoom! is an excellent game even as it is, I would welcome 
  717. any ideas on how it can be improved.